home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / dev / misc / FlexCat.readme < prev    next >
Encoding:
Text File  |  2000-01-02  |  8.4 KB  |  184 lines
  1. Short:    2.4 - Flexible catalogs (C, Asm, Oberon, E, ARexx, Modula...)
  2. Author:   Marcin Orlowski <carlos@amiga.com.pl>
  3. Uploader: Marcin Orlowski <carlos@amiga.com.pl>
  4. Version:  2.4
  5. Type:     dev/misc
  6. Www:      http://amiga.com.pl/flexcat/
  7. Date:     Sun Nov 28 04:21:13 1999
  8.  
  9.  
  10.  
  11.   INFO
  12.   ----------
  13.  
  14.     FlexCat creates catalogs and the source to handle them.  The difference
  15.   between FlexCat and KitCat, CatComp and some others is, that FlexCat is
  16.   designed to produce any source you want:  any programming language, any
  17.   individual needs should be satisfied.  However, FlexCat is not more
  18.   difficult to use.
  19.  
  20.     Translators will also find it useful, as, among standard functions
  21.   like #?.catalog creation, FlexCat is able to update your #?.ct files
  22.   to the new #?.cd files automatically. Give it a try! 
  23.  
  24.     This sounds like a contradiction.  FlexCat's solution is to use
  25.   template files, the so called "source descriptions".  Ready to use examples
  26.   for Assembler, C, C++, E, Oberon and Modula-2 are distributed, additionally
  27.   an example for supporting catalogs on Workbench 2.0.  Any other examples
  28.   are welcome.
  29.  
  30.  
  31.   Archives
  32.   ----------
  33.  
  34.     Since release 2.0, the FlexCat distribiution is splitted into the
  35.   smaller archives. They are (in order of importance):
  36.  
  37.   FlexCat.lha           - Latest FlexCat, user contribitions, english manual
  38.                          and foreign catalog files
  39.  
  40.   FlexCat_0x0.lha       - patches for 020, 040 and 060 versions of FlexCat
  41.                          (PPC makes no sense here. I checked that).
  42.  
  43.   FlexCat_ExDocs.lha    - FlexCat's guide in non english languages. Currently
  44.                          Svenska, Espanol and Deutsch are provided
  45.  
  46.   FlexCat_CatSrc.lha    - #?.cd and #?.ct files for existing translations and
  47.                          #?.texinfo documents
  48.  
  49.   FlexCat_Src.lha       - C source code for the FlexCat itself
  50.  
  51.   FlexCat_Demos.lha     - example source codes -> shows how to make localized
  52.                           programs using FlexCat (C/HSPascal/ARexx/etc)
  53.  
  54.                           NOTE: I would gladly welcome examples for other
  55.                           languages (E/Asm etc) as well as detailed tutorials 
  56.                           about right way of doing localized software.
  57.                           Your contribution is highly welcome!
  58.  
  59.  
  60.   If you just want to use FlexCat, the 1st archive is all you need.
  61.   If you want to have CPU optimised binaries, take both 1st and 2nd
  62.   and patch the original release.  If you want to read translated manual,
  63.   get the 3rd one.  If you want to make the translation take the 4th one
  64.   (but I suggesto to join the Amiga Translators' Organisation
  65.   <http://ato.vapor.com/ato> first!)
  66.  
  67.  
  68.   Changes since previous release:
  69.   -------------------------------
  70.   * v2.4 (28.11.99) - FlexCat is now portable! Thanks to Hardcode.sd{tm}
  71.                       unique technology you can now try to compile FlexCat
  72.                       under any OS (both Big and Little Endians are
  73.                       supported). Read developer.readme for details.
  74.  
  75.                     - sometimes garbage could be written instead of
  76.                       $VER: string (when $TODAY feature was used) due
  77.                       to memory block being free'd before write.
  78.  
  79.                     - added ##rem command to .sd file handling. As you
  80.                       have probably guessed, it's just remark. The goal
  81.                       (at least for me) is that ##rem lines won't appear
  82.                       in result source code, creaded out of the .sd file.
  83.  
  84.                     - added manual catalog open/close for compilers that
  85.                       do not handle autoinit/exit functions
  86.  
  87.                     - Updated french translation (Herve Dupont
  88.                       <herve.dupont@nordnet.fr>)
  89.  
  90.                     - Added NOSPACE switch, to avoid extra space char
  91.                       usually used by FlexCat to separate comment
  92.                       mark ';' from the main comment text
  93.  
  94.                     - Source descriptor for HSPascal by Artur Karpunin
  95.                       <woody8@kki.net.pl> is now available.
  96.  
  97.                     - New archive "FlexCat_Demos" full ;-) of example
  98.                       source codes for various programming languages
  99.                       C, HSPascal and ARexx examples are recently
  100.                       available.
  101.  
  102.                     - Content of "Contribution" drawer is now moved to
  103.                       "FlexCat_Demos" archive.
  104.  
  105.                     - Added detailed tutoral (in polish for now) about
  106.                       the whole localization process (incl. examples)
  107.  
  108.  
  109.   * v2.3 (19.05.99) - "Trailing ellipsis" detector was broken (Marco
  110.                       De Vitis <marco.dvv@flashnet.it>)
  111.  
  112.                     - Seems I updated the english manual for v2.2, but
  113.                       forgot to create .guide file out of texinfo.
  114.  
  115.                     - Fixed manual to say "1999" instead of "1998", and
  116.                       fixed #?.cd file to show proper arguments when
  117.                       help ("?") is requested (Herve Dupont
  118.                       <herve.dupont@nordnet.fr>)
  119.  
  120.                     - Spanish translation by Sergio Martín Rodríguez
  121.                       <smartin@kaos.es> and Tomás J. Cantó
  122.                       <tjcanto@redestb.es>
  123.  
  124.  
  125. ============================= Archive contents =============================
  126.  
  127. Original  Packed Ratio    Date     Time    Name
  128. -------- ------- ----- --------- --------  -------------
  129.     2628    1138 56.6% 09-Jun-99 14:18:46 +FlexCat.catalog
  130.     3584    1564 56.3% 09-Jun-99 14:18:58 +FlexCat.catalog
  131.     3680    1668 54.6% 09-Jun-99 14:18:56 +FlexCat.catalog
  132.     3778    1669 55.8% 09-Jun-99 14:18:44 +FlexCat.catalog
  133.      637     303 52.4% 18-Aug-99 15:32:30 +ato.readme
  134.     2992    1372 54.1% 09-Jun-99 14:18:54 +FlexCat.catalog
  135.     3646    1688 53.7% 09-Jun-99 14:19:00 +FlexCat.catalog
  136.     3488    1514 56.5% 09-Jun-99 14:18:56 +FlexCat.catalog
  137.     3072    1419 53.8% 09-Jun-99 14:18:50 +FlexCat.catalog
  138.     3828    1839 51.9% 09-Jun-99 14:18:52 +FlexCat.catalog
  139.     4462    1839 58.7% 09-Jun-99 14:18:54 +FlexCat.catalog
  140.     2390    1164 51.2% 09-Jun-99 14:18:46 +FlexCat.catalog
  141.     3324    1543 53.5% 09-Jun-99 14:18:58 +FlexCat.catalog
  142.     3404    1565 54.0% 09-Jun-99 14:18:48 +FlexCat.catalog
  143.     3276    1514 53.7% 09-Jun-99 14:18:48 +FlexCat.catalog
  144.     3300    1492 54.7% 09-Jun-99 14:18:50 +FlexCat.catalog
  145.     3312    1599 51.7% 09-Jun-99 14:18:48 +FlexCat.catalog
  146.      632     277 56.1% 18-Aug-99 15:32:20  Docs.info
  147.    64090   20790 67.5% 19-May-99 11:57:30 +FlexCat_english.guide
  148.      464     241 48.0% 25-May-97 15:47:24 +FlexCat_english.guide.info
  149.    34800   20285 41.7% 28-Nov-99 04:35:34  FlexCat
  150.    20042    6602 67.0% 28-Nov-99 04:24:28  FlexCat.history
  151.     5324    2255 57.6% 28-Nov-99 04:21:34  FlexCat.readme
  152.     2050     888 56.6% 28-Nov-99 04:36:40 +AmigaOberon.sd
  153.     1068     618 42.1% 28-Nov-99 04:36:40 +ARexx.sd
  154.     2809    1177 58.0% 28-Nov-99 04:36:40 +AutoC_c.sd
  155.      580     303 47.7% 28-Nov-99 04:36:40 +AutoC_h.sd
  156.     2969     914 69.2% 28-Nov-99 04:36:40 +AztecAs_asm.sd
  157.      503     238 52.6% 28-Nov-99 04:36:40 +AztecAs_i.sd
  158.     3339    1320 60.4% 28-Nov-99 04:36:40 +C++_CatalogF.cc
  159.     1525     732 52.0% 28-Nov-99 04:36:40 +C++_CatalogF.h
  160.      566     294 48.0% 28-Nov-99 04:36:40 +C++_cc.sd
  161.      798     429 46.2% 28-Nov-99 04:36:40 +C++_h.sd
  162.     5479    1967 64.0% 28-Nov-99 04:36:40 +C_c.sd
  163.     6471    1940 70.0% 28-Nov-99 04:36:40 +C_c_V20.sd
  164.     1825     751 58.8% 28-Nov-99 04:36:40 +C_c_V21.sd
  165.      790     413 47.7% 28-Nov-99 04:36:40 +C_h.sd
  166.     1570     845 46.1% 28-Nov-99 04:36:40 +Cat2h.readme
  167.     1857     794 57.2% 28-Nov-99 04:36:40 +Cat2h_c.sd
  168.      428     227 46.9% 28-Nov-99 04:36:40 +Cat2h_h.sd
  169.     2522     809 67.9% 28-Nov-99 04:36:40 +CatComp_h.sd
  170.     2090     708 66.1% 28-Nov-99 04:36:40 +E21b.sd
  171.     2560     835 67.3% 28-Nov-99 04:36:40 +E30b.sd
  172.     2183     833 61.8% 28-Nov-99 04:36:40 +E32e.sd
  173.      860     403 53.1% 28-Nov-99 04:40:04 +Hardcode_h.sd
  174.     3637    1313 63.8% 28-Nov-99 04:36:40 +HSPascalUnit.sd
  175.      552     329 40.3% 28-Nov-99 04:36:40 +Modula2Def.sd
  176.     2324     886 61.8% 28-Nov-99 04:36:40 +Modula2Mod.sd
  177.     2231     923 58.6% 28-Nov-99 04:36:40 +Oberon-A.sd
  178.     1818     798 56.1% 28-Nov-99 04:36:42 +Oberon_V38.sd
  179.     1817     797 56.1% 28-Nov-99 04:36:42 +Oberon_V39.sd
  180.     3033     927 69.4% 28-Nov-99 04:36:42 +SASasm_a.sd
  181.      486     231 52.4% 28-Nov-99 04:36:42 +SASasm_i.sd
  182. -------- ------- ----- --------- --------
  183.   240893   98982 58.9% 01-Dec-99 20:30:00   53 files
  184.